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Important User Information 


Because of the variety of uses for the products described in this publication, 

those responsible for the application and use of this control equipment must 

satisfy themselves that all necessary steps have been taken to assure that each U 
application and use meets all performance and safety requirements, including 

any applicable laws, regulations, codes and standards. 


The illustrations, charts, sample programs and layout examples shown in this 
guide are intended solely for purposes of example. Since there are many 
variables and requirements associated with any particular installation, the 
Allen-Bradley Company, Inc. does not assume responsibility or liability (to 
include intellectual property liability) for actual use based upon the examples 
shown in this publication. 


Allen-Bradley Publication SGI-1.1, “Safety Guidelines for the Application, 
Installation and Maintenance of Solid State Control” (available from your local 
Allen-Bradley office) describes some important differences between solid-state 
equipment and electromechanical devices which should be taken into 
consideration when applying products such as those described in this 
publication. 


Reproduction of the contents of this copyrighted manual, in whole or in part, 
without written permission of the Allen-Bradley Company Inc. is prohibited. 


Throughout this manual we use notes to make you aware of safety 
considerations: 


ATTENTION: Identifies information about practices or 
circumstances that can lead to personal injury or death, property 
damage or economic loss. 


Attentions help you: 


« identify a hazard 
» avoid the hazard 
= recognize the consequences 


Important: Identifies information that is especially important for 
successful application and understanding of the product. 


ControlView is a trademark and PLC is a registered trademark of Allen-Bradley Company, Inc. 
Mouse GRAFIX is a trademzrk of Dynapro Systems Inc. 
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Summary of Changes 
Changes from Release 2.0 to The following changes have been made to the Derived Tags option and the 
3.0 Derived Tags User Manual since release 2.0: 


For information on this new feature: 


The feature appeared in: 


ControlView Installation Manual 


Installation instructions for the Derived Tags option have been moved to 
the ControlView Installation Manual. 


software release 3.0 


SC-1 


How To Use This Manual 


Preface 


Preface 


This manual describes the features and capabilities of the Derived Tags 
option of the Control View™ System. 


The Derived Tags processor is used to continuously calculate complex 
equations, called expressions, and to store the results in the Control View 
Current Value Database. These expressions can be composed of 
mathematical operations, tag values from the Current Value Database, 
IF-THEN-ELSE logic, and other special functions. 


Results of the expressions are stored as local tags in the Current Value 
Database (CVD) and can be used by other applications such as Trending, 
Alarming, the Event Detector, and C-Toolkit programs. 


For more information on local tags, refer to the ControlView Core User 
Manual, Chapter 3, The Setup Menu. 


Conventions Used in This Manual 


This manual follows the print conventions outlined in the Control View 
Core User Manual. 


Audience 


Since the Derived Tags module is a part of ControlView, you should be 
familiar with Control View and have the ControlView Core User Manual 
available for reference. A complete list of related publications is contained 
in that manual. 
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Derived Tags Commands 
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Defining Derived Tags 


The Derived Tags processor continuously calculates expressions, and 
stores the results in the Current Value Database. These expressions can be 
composed of mathematical operations, tag values from the Current Value 
Database, IF-THEN-ELSE logic, and other special functions. Chapter 2, 
Defining an Expression, describes how to create expressions. 


Local tags are used to store the result of the expression. This chapter 
explains how to define a local tag, using the Derived Tag Editor. Local tags 
are never updated with values from the programmable controller. 


For complete instructions on defining tags, see the ControlView Core User 
Manual, Chapter 2, The Setup Menu. To create a local tag: 


= 


Load the database editor and select a database. 

2. Add anew analog or digital tag. 

3. Specify the Address Type as "None". 

4.  Leavethe Address, Scan Class and Node fields blank. 


5.  Enteran Initial Value. For analog tags, keep this between the 
Minimum and Maximum values. For digital tags, use the text entered 
as the On or Off label for the initial value. 


Remember that for each derived tag you want to define, there must be a 
local tag in the database. Once the local tags have been created, go on to 
define the derived tags. 


At the time of this release, string tags are not supported by this option. 
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The Derived Tag Editor 


To create or edit a file of derived tags, choose Edit Derived Tags under 
Configure in the Setup Menu. 


You are prompted to name a derived tag file. You may type in: 
a the name of an existing file, to modify it 


If you have forgotten the name of a derived tag file, go to the Actions 
Menu and select Start Derived Tags under Start/Stop to display a popup 
list of available tag files. 


= anew name, to create a file 
= leave the field blank, to use the default Derived Tag file called DTAGS 


One of the features of the Derived Tag Editor is autoverification. When 
turned on, it checks to ensure that every derived tag specified actually 
exists as a local tag in your database. It also checks that every tag used in 
an expression also exists in the database. If you intend to add 
autoverification to a derived tag, load the database before you open the 
Derived Tag Editor. (Autoverification is set with Setup in the Derived Tags 
Editor.) 


Important: Autoverification does not affect system performance. J 
(However, turning off autoverification enables you to develop a derived tag 
list for a database that does not exist locally.) 
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Figure 1.1 
Starting the Derived Tag Editor 


Screens | Security | Document | Tools | Actions | Exit | 


Configure Data Channel 
Configure Devices 
Configure KT 

Configure Mouse 
Configure Touch Screen 
Configure Printers 
Configure Novell Printers 
Configure TCP/IP Printers 
Configure Phone List 
Configure ControlView Nodes 
Configure Scan Classes 


Edit Database 


Which derived tag file? 
SALAD _ 


Accept <+>] Cancel <Esc>] 
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In the following sections, the menu items are described in left-to-right 
order. 


If the file is empty, the first thing to do is choose Insert and define a 
derived tag. 


Figure 1.2 
The Derived Tag File Editor 


Derived Tag File Editor 
Delete | Move | Copy | Setup | 


Description 


MIXER.INFLOW{§ Mixer inflow derived tag oil + vinegar 


OIL.LEVEL Oil level animation 
VIN.LEVEL Oil level animation 


Insert 


Modify 
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Modify 


To edit a derived tag, highlight the tag name and choose Modify, or 
double-click on the derived tag name. 
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Figure 1.3 
Modify Derived Tag Window 


Modify Derived Tag 


Derived Tag: Description: 
[MINER INFLOW] 


Expression: 


Accept <+>] Cancel <Esc>] 
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You can edit any of the three fields. For details on the Derived Tag, 
Description and Expression fields, see the description of Insert. 


Save the changes with the Accept button or the + key. 


Insert 


To create a new derived tag: 


1. Determine where the new tag will go by highlighting a tag in the 
Derived Tag Editor. The new tag will appear below the selected one. 


2. Choose Insert to add a new tag. The Insert Derived Tag window 
opens. 


Important: Derived tags are processed in the order they are listed. So, if 
the tag you are about to create depends on the value of a tag in the list, then 
it should be placed after that tag. 


Figure 1.4 
Insert Derived Tag Window 


Derived E Description: 


Expression: 


Accept <+> | Cancel <Esc>] 
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= Derived Tag 
Type a tagname for a local tag which will hold the derived tag value. 

= Description 
Enter a brief description to identify the derived tag. This description 
appears in the Derived Tag Editor and is displayed only for your 
information. 

= Expression 
Enter the expression which will create the derived tag value in this field. 
For details on how to use the Expression field, see Chapter 2, Defining 


an Expression. 


Save the derived tag with the Accept button or the + key. The new 
definition will appear in the Derived Tag Editor. 


Delete 
To erase a derived tag definition, highlight the tag and choose Delete. The 


tag's definition appears in a window as illustrated in Figure 1.5. Confirm 
the deletion with the Accept button or the + key. 


Figure 1.5 
Delete Derived Tag Window 


elete Derived Tag 


Derived Tag: Description: 
MIXER.INFLOW Mixer inflow derived tag oil + vinegar 


Expression: mixer.oilin + mixer.vinin 


Accept <+>] Cancel <Esc>] 
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Move 
Derived tags are processed in the order they are listed. Therefore, if 


derived tag2 depends on the value of derived tag1, ensure tagl is listed 
earlier, so that tag2 uses the most up-to-date value. 
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To change the order of the derived tag list, highlight a tag name and choose 
Move. The highlighted tag disappears from the list and a flashing blue bar 
appears over the next tag in the Derived Tag Editor. 


To reposition the tag, highlight the new position and press Enter, or 
double-click on the desired destination. The tag will be placed below the 
highlighted entry. 


Important: To move a tag to the top of the list, move it below the top 
entry, then move the top entry down one position. 


Figure 1.6 
Moving a Derived Tag 


Derived Tag File Editor 


Modify} Insert | Delete NEU | Cops | Setup 


Highlight and choose 
Move. ———————————- Mixer inflow derived tag oil * vinegar 
OIL.LEVEL Oil level animation 
VIN.LEVEL Oil level animation 


Derived Tag File Editor 
Insert | Delete BUG vam Copy} Setup | Path. 


Derived Tag 


Description 


[Ont ever animation 
Oil level animation 
Insert | Delete | Move | Copy | Setup | Path | 


Description 


The entry disappears and 
the next entry is —————— —— —— —» 


highlighted. 


Derived Tag 


Press Enter a second OIL.LEVEL Oil level animation 


time to insert the entry. ———————— —— —» BAGN KON Mixer inflow derived tag oil + vinegar 
VIN.LEVEL Oil level animation 
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Copy 


To duplicate a derived tag definition, highlight the tag and choose Copy. 
An identical entry appears below the original. 
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Figure 1.7 
Copying a Derived Tag 


Derived Tag File Editor 
Modify| Insert | Delete | Move 


Derived Tag Description 


OIL.LEVEL Oil level animation 


MIXER.INFLOWIB Mixer inflow derived tag oil + vinegar 


VIN.LEVEL Oil level animation 


Modify| Insert | Delete | Move 


Derived Tag Description 


OIL.LEVEL Oil level animation 
MIXER.INFLOW | Mixer inflow derived tag oil * vinegar 
MIXER.INFLO Mixer inflow derived tag oil + vinegar 
VIN.LEVEL Oil level animation 
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You can then move or modify the copy. 


Setup 
Choose Setup to define the characteristics of the derived tag file; the 


following window appears. 


Figure 1.8 
Derived Tag File Attributes Window 


Derived Tag File Attributes 


Derived Tag: SALAD 


Description: 
Evaluation Period: [ 5 ^ | seconds 


Autoverification: [Noe] 


Accept <+>) Cancel <Esc>] 
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a Derived Tag File 
This field contains the name of the file that was originally loaded. 


Important: Depending on the size of the expressions, each file can 
contain as many as 300 derived tags, accessing a maximum of 600 tags. 


a Description 


Enter a brief description of the file to identify it. This explanation is 
used only for documentation purposes. 


a Evaluation Period 


The derived tag processor continually cycles through the list of derived 
tags, evaluating each expression and updating the local tags. The 
frequency of this cycle, or Evaluation Period, ranges from 0 to 
99,999,999 seconds. 


To complete this field, specify, in seconds, how often the processor 
should cycle through the list of tags. 


An Evaluation Period of 0 means the processor will cycle through the 
list as fast as possible without pausing. However, such speed can tie up 
the processor and impair system performance. 


If your expressions rely on tag values, remember that tags are assigned 
to scan classes. The scan class determines how often the tag is updated 
with new PLC? values. Keep the different scan classes in mind as you 
determine the derived tag's evaluation period. 


Set the evaluation period for the derived tags to a rate equal to or slower 
than the scan rate. If you set the rate faster, the expressions will be 
performing calculations using PLC values that haven't changed since 
the last evaluation, and the system will be burdened with needless 
processing. For more information on scan classes, see ControlView Core 
User Manual, Chapter 2, The Setup Menu. 


» Autoverification 
When autoverification is on, the editor will make sure that all tags used 
in the expression exist in the database, and that the tag named as the 


derived tag is a local one. For autoverification to work, you must load 
the database before you call up the editor. 


Choose YES for autoverification, NO to turn it off. 


Start the Derived Tag 
Processor 
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Important: Immediately after autoverification is applied, the system 
slows down while the existing database is checked. After this initial 
database check, autoverification does not affect system performance. 


Important: When you start the Derived Tag Editor from the menu, 
(instead of the command line) autoverification will always be turned off, 
regardless of the setting of this field. 


Path 


Specify the DOS pathname where the derived tags file is located. The 
default directory is C:\ACCESS\DT where C is the drive where 
Control View is installed. 


Important: Whenever you configure a pathname, be sure to start with the 
drive letter. This is absolutely essential when running Control View in a 
multi-drive environment. 


Important: This path must be used by all derived tag files and must not 
be altered for individual files. The derived tag processor will only work 
from the specified path. Changing the path of an existing derived tag file, 
moves the file to the new location, deleting it from the old location. 


Figure 1.9 
Configure Derived Tags Path Window 


Configure Derived Tags Path 


All derived tags files are referenced via this directory path. 
Enter the new derived tags directory path. 


Accept <+>] Cancel <Esc>] 
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Before starting the Derived Tag Processor, load the database containing all 
the local tags and the tags used in the Derived Tag Expressions. To load the 
processor, choose Start Derived Tags under Start/Stop in the Actions menu. 
A list of the derived tags files will appear. Choose the file you wish to run. 


Important: Only one file can be run at a time. 
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Stop the Derived Tag To stop the Derived Tag Processor, choose Stop Derived Tags under 
Processor Start/Stop in the Actions menu. 


Defining an Expression 
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Defining an Expression 


Sometimes the data gathered from remote drivers is only meaningful when 
you: 


= combine it with other values 

= compare it to other values 

= create a cause - effect relationship with other values 

Expressions allow you to create mathematical or logical combinations of 
data that return more meaningful values. The term refers to an entire 
equation whereas a segment of an expression is called a statement. 
Expressions can be built from: 

= tag values 

" constants 

= mathematical, relational, logical, and bitwise operators 

= built-in functions 

* IF-THEN-ELSE program logic 


Important: All expressions return floating point values. 


Example: Expressions vs Statements 
(tagl * tag2) AND (tag3 / 2) 
is an expression 

(tag3 / 2) 


is a statement 
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Tag Values 


Constants 


Arithmetic Operators 


2-2 


A tag can be included as part of an expression, or can stand alone as the 
entire expression. 


Using the number 123.45 as an example, a constant could have any of the 
following formats: 


a integer (123) 
» floating point value (123.45) 


» scientific notation (1.2345E2) 


The arithmetic operators are as follows: 


Table 2.A 
The Arithmetic Operators 


Symbol Example 
eaiion [asina 
uda fag 
| uico agi ag 
| avse — CC 
MOD, % tagi % tag2 
: [men [i7 


Important: The modulus operator is the remainder of one number divided 
by another. 
For example, the remainder of 13 divided by 5 is 3; so 13 % 5 2 3. 


Important: Expressions which attempt to divide a number by zero are 
ignored. No error message is given. Be sure that any tag value which is 
used as a divisor cannot at some point have a value of zero. 


Example: Arithmetic Operators 


For these examples, tag] = 5 and tag2 = 7. 


tagl + tag2 
returns a value of 12 


tagl * tag2 
returns a value of 35 


" | 
tagl - tag2 C 


returns a value of —2 


Relational Operators 
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tagl / tag2 
returns a value of 0.71 


tagl MOD tag2 
returns a value of 5 


tagl ** tag2 
returns a value of 78125 


Important: Operator precedence is explained later in this chapter. 


Relational operators compare two values to provide a true or false result. If 
the statement is true, a value of 1 is returned. If false, 0 is returned. There 
are six relational operators; each has two different symbols. 


Table 2.B 
The Relational Operators 


Symbols Example 
= eui — — (CI 
NE, <> tag! <> tag2 
LT, « lessthan | tag < tag2 
GT,» tag > tag2 
LE, «- tag! <= tag2 
GE, »- tag1 >= tag? 


Example: Relational Operators 
For these examples, tag] = 5 and tag2 = 7. 


tagl > tag2 
is false, so the expression returns a 0 


tagl LE tag2 
is true, so the expression returns a 1 


tagli e 5 
is true, so the expression returns a 1 
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Logical Operators 


Logical operators determine the validity of one or more statements. The 
operators return a value of 1 if the expression is true, or a value of 0 if 
false. There are three logical operators: AND, OR, and NOT. 


= AND returns a value of 1 if the statement to the right and to the left of 
the operator are both true 


a OR returns a value of 1 if either the statement to the left or to the right 
of the operator is true 


a NOT reverses the logical value of the statement it operates on 
Important: Any statement which evaluates to a non-zero value is regarded 


as true. For example, the statement “tag1” will be false if the value of tag1 
is 0 (zero), and true if tag1 has any other value. 


Table 2.C 
The Logical Operators 


Symbols Example 
(tag1 « tag 2) AND (tagt = 5) 
(tag1 = 5) OR (tag1 = 10) 


NOT(tag1 > tag2) 


negation 


Example: Logical Operators 
For these examples, tag] = 5 and tag2 = 7. 


(tagl < tag 2) AND (tagl = 5) 
returns a 1 since both statements are true 


tagl && tag2 
returns a 1 since neither tag1 nor tag2 are 0 


(tagl > tag2) OR (tagl = 5) 
returns a value of 1 since tag] = 5 is true 


NOT(tagl < tag2) 


tagl < tag2 is true and would return a 1 but the NOT operator reverses the 
logical value, so 0 is returned 


Important: The parentheses are essential in the above expressions. 


Bitwise Operators 


bit in first operand 
bit in second operand 
result of & operation 
result of | operation 

result of ^ operation 
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Bitwise operators allow you to examine and manipulate individual bits 
within a value. These operators can only be applied to integers, not floating 
point numbers. 


Table 2.D 
The Six Bitwise Operators: 


Symbol Example 
| raser — AT 
Cr us 


The bitwise operators &, |, and ^ compare two integers or tags on a bit by 
bit basis. The >>, <<, and - operators manipulate a single integer or tag. 


The bitwise AND ( & ) returns an integer with a bit set to 1 if both of the 
corresponding bits in the original numbers are 1. Otherwise, the resulting 
bit is 0. 


The bitwise inclusive OR (| ) returns an integer with a bit set to 1 if either 
or both of the corresponding bits in the original numbers are 1. If both bits 
are 0, the resulting bit is 0. 


The bitwise exclusive OR (^) returns an integer with a bit set to 1 if either 
of the corresponding bits in the original numbers is 1. If both bits are 1 or 
both are 0, the resulting bit is 0. 

The bitwise operators &, |, and ^ are illustrated below: 


Figure 2.1 
The &, |, and ^ Bitwise Operators 


41238 


The shift right operator ( »» ) shifts the bits within the left operand by 
the amount specified in the right operand. The bit on the right disappears. 


Figure 2.2 shows the result of the expression 114 >> 1 = 57. 
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zero shifted in 


Figure 2.2 
The Shift Right Operator 


ofifr[rfofofifo] em 


IN Å \ bit disappears 


TET: =57 


40239 


Either a 0 or a 1 is shifted in on the left, depending on whether the integer 
is signed or unsigned. With unsigned integers, 0 is always shifted in on the 
left; with signed integers, a 0 is shifted in when the number is positive (i.e. 
the leftmost bit, the sign bit, is 0), and a 1 is shifted in when the number is 
negative (i.e. the leftmost bit, the sign bit, is one). In other words, with 
signed integers, the sign of the number is always maintained. 


The shift left operator ( << ) shifts the bits within the left operand by the 
amount specified in the right operand. The bit on the left disappears and a 
0 is always shifted in on the right. 


The bitwise complement operator ( - ) reverses every bit within the 
number, so that every 1 bit becomes a 0 and vice versa. 


Example: Bitwise Operators 
For these examples tag1 = 5 (binary 0101), tag2 = 2 (binary 0010) 


tagl & tag2 
returns 0 (binary 0000) 


tagl | tag2 
returns 7 (binary 0111) 


tagl * tag2 
returns 7 (binary 0111) 


tagl >> 1 
returns 2 (binary 0010) 


tagl << 1 
returns 10 (binary 1010) 


~ tagl 
returns 10 (binary 1010) 


Built-in Functions 
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There are three types of built-in functions: 


= functions involving tags 


= functions involving the time 


« functions involving file operations 


These functions return floating point values. 


Many of the functions check for specific true/false conditions. Such 
functions return 1 if the condition is true, and 0 if the condition is false. For 
instance, the COMM ERR) function returns 1 if the specified tag has a 


communication error. 


Tag Functions 


The following built-in functions examine the status of a tag: 


Table 2.E 

Tag Functions 
This function: 
SQRT(tag) 
COMM_ERR (tag) 


ALM_SUPPRESS(tag) 
ALM_FAULT(tag) 
ALM_SEVERITY (tag) 


ALM_LEVEL(tag) 


ALM_ACK (tag) 
ALM_IN_ALARM(tag) 


returns this value: 
the square root of the tag (or of a constant). 


TRUE if a read or write operation for the specified tag produced a 
communication failure. 


TRUE if the tag's alarms are suppressed. 
TRUE if there has been an alarm fault for the specified tag. 


the severity of the alarm—a value between 1 and 8, or 0 if the tag 
isn't in alarm. 


the alarm level for the tag: a value between 1 and 8, or 0 if the tag 
isn't in alarm. 


TRUE if the tag's alarm has been acknowledged. 
TRUE if the tag is in alarm. 


Important: The alarm (ALM_) functions will only be relevant if the 
Alarming option is installed. 


sh 


Example: Tag Functions 


ALM IN ALARM(vessel3.TIC3.pv) 
returns 1 if the tag is in alarm or O if it isn't. 


SORT (vessel3.TIC2.pv) 
returns the square root of the tag's value. 
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SQRT (25) 
returns a value of 5. 


Time Functions 


The following built-in functions examine the system time. These functions 
use the time parameter. 


Important: The time parameters must be surrounded by quotes. 

The time parameter can include the following options: 

= day of week [Sun, Mon, Tue, Wed, Thu, Fri, or Sat] 

» month [Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, or Dec] 
= date [1-31] 

= year [1980-2100] 


a hour of day [00: — 23:] 


» minute [:00 - :59] 


It doesn't matter what order you list these options in. 


Example: Time Parameter 


The following all represent the same date and time, and are valid time 
parameters: 


a "fri aug 18 1989 17:00" 
* "fri aug 18 1989 17: :00" 


» ":00 aug 18 fri 1989 17:" 


Important: The validity of the date is not checked, so if Aug 18 1989 is 
not a Friday, this error will not be detected. 


2-8 


^y 


Chapter 2 


Defining an Expression 


Example: Incomplete Time Parameter 
The following are valid examples of incomplete time parameters: 


= "17:00" 
means once a day at 5:00 pm 


"u " : 3 0 " 
means once an hour, on the half hour 


t ofri 172" 
means 5:00 pm each Friday 


Table 2.F 
Time Functions 


This function: 
TIME(” time”) 
BEFORE. TIME("time”) 


returns this value: 


TRUE if the time specified is the current time. 


TRUE if the expression is evaluated before the 
specified time. 


TRUE if the expression is evaluated after the 
specified time. 


AFTER. TIME( fime) 


EEE 
Example: Incomplete Time Parameter 


TIME(”sun feb 18 1990 14:30”) 


returns 1 if it is exactly 2:30 pm on Sunday Feb 18, 1990; otherwise 0 is 
returned. 


Important: If the Evaluation Period is greater than 60 seconds, this 
function may never be evaluated as true. 


AFTER TIME("sun feb 18 1990 14: :30") 


returns 1 the first time the expression is evaluated after 2:30 pm on Sunday 
Feb 18, 1990 and will continue returning 1 from this point on. 
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Operator Precedence 
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BEFORE TIME("Feb 18 1990") 


returns 1 if it is not yet Feb 18, 1990; returns O if the date is on or after Feb 
18, 1990. 


File Functions 


The following built-in functions determine whether a specific file exists, 
and how much free space there is on a disk. 


The file parameter is the DOS pathname, surrounded by quotes. 
The drive parameter is the letter of the drive. 


Table 2.G 
File Functions 


returns this value: 
TRUE if the specified file exists. 
the number of bytes free on the specified drive. 


This function: 
FILE EXISTS("file") 
FREE. BYTES(drive) 


mme 


Examples: File Functions 


FILE_EXISTS (”e: \access\dat\activity.000”) 
returns 1 if the file exists or 0 if the file doesn’t exist. You may want to use 
this for setting tags when a specified file has been created or deleted. 


FREE BYTES(c) 
returns the number of bytes available on drive C. You may want to display 
it on a system graphic or to create an alarm when disk space is getting low. 


There are three rules used to determine the order for evaluating an 
expression that has more than one operator. 


1.  Theoperator with the highest precedence is evaluated first. 


2. When two operators have equal precedence, they are evaluated from 
left to right. 


3.  Tochange the order of precedence, use parentheses. 
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Here are the operators from highest to lowest precedence: 


Table 2.H 
Operator Precedence 


Precedence Level Name 0 Symbols 


Te pem 0 


J Logical negation NOT 
Bitwise complement = 


3 multiplication $ 
division / 
modulus (remainder) MOD, % 
exponent is 
logical and AND, && 
bitwise and & 
bitwise shift right >> 
bitwise shift left << 

4 addition + 
subtraction - 
logical or OR, II 
bitwise inclusive or | 
bitwise exclusive or A 
the built-in functions 

5 (lowest) equal EQ, = 
not equal NE, <> 
less than LT, < 
greater than GT, > 


less than or equal to 
greater than or equal to 


Example: Operator Precedence 

For these examples, tag] = 5, tag2 = 7 and tag3 =10. 
(tagl > tag2) AND (tagl < tag 3) 

is evaluated in this sequence: 

1. tagl >tag2=0 

2. tagl<tag3=1 

3.  OANDISO 

The expression evaluates to 0. 

tagl>tag2 AND tag3 


is evaluated in this sequence: 
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1. tag2 AND tag3 = 1 

2. tagl>1l=1 

The expression evaluates to 1. 

NOT tagl AND tag2 > tag3 ** 2 
is evaluated in this sequence: 

1. NOT tagl =0 

2. OANDtag2=0 

3. tag **22 100 

4. 0>100=0 


The expression evaluates to 0. 


IF-THEN-ELSE The IF-THEN-ELSE structure allows an expression to make a decision. 
The format of the IF-THEN-ELSE structure is: 
IF statement THEN value] ELSE value2 


If the statement is true then the expression will return valuel; if the 
statement is false then the expression returns value2. Keep in mind that the 
statement is a mathematical equation and that true means a non-zero value, 
and false means zero. 


The IF-THEN-ELSE structure is illustrated below. 
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Figure 2.3 
The IF-THEN-ELSE Structure 


<> false 


| true 


: 


value2 
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Nested IF-THEN-ELSE structure 


It is common to nest an entire IF-THEN-ELSE structure inside another 
IF-THEN-ELSE structure. 


When nesting IF-THEN-ELSE structures, it is important to remember that 
an ELSE is associated with the last IF that doesn't have its own ELSE. 


Example 1: Nested IF-THEN-ELSE 


This expression: 

IF (statementl) THEN (valuel) 

ELSE IF (statement2) THEN (value2) 
ELSE (value3) 


has this interpretation: 
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Figure 2.4 
Nested IF-THEN-ELSE 


true 
statement 


| false 


false 
TEN 


Y 
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Example 2: Nested IF-THEN-ELSE 
This expression: 


IF (statementl) THEN 
IF (statement2) THEN (valuel) 
ELSE (value?) 

ELSE (value3) 


has this interpretation: 


^ Comments 


» Expression Formatting 
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Figure 2.5 
Nested IF-THEN-ELSE 


true 


i false | false 


value3 value2 
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Comments begin with an exclamation point. All text following the 
exclamation point, to the end of the line, is not evaluated. 


Example: Comments in a ControlView Expression 
In a single line such as: 
IF a»b THEN c ELSE d ! if/then expression 
only that part preceding the exclamation point is evaluated. 
In several lines such as: 
IF a»b ! temp a greater than temp b 

THEN c ! shut valve 


ELSE d ! do nothing 


only those parts preceding the exclamation points in each line are 
evaluated. 


The derived tag editor ignores tabs, new line characters, and multiple 


spaces, so a large expression can be condensed to make maximum use of 
the editor space. 
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Example: Expression Formatting 

The following expression: 

If (tagl > tag2) then 0 

else if (tagl > tag 3) then 2 
else 4 


Could be condensed to the following: 


If (tagl > tag2) then 0 else if (tagl > tag3) then 
2 else 4 


Important: Do not allow tag names, keywords, function names or 
function arguments to span more than one line. 


DERIVED 


DERIVEDOFF 


Appendix 


Derived Tags Commands 


DERIVED [file] [/n] 


Calls up the Derived Tag Editor, which is used to create or modify a file of 
derived tags. The parameters are: 


[file] Is the name of the derived tag file (without a file 
extension). If you omit [file], the Editor loads the default 
file DTAGS. 

[/n] Turns autoverification off while the file is loading. When 


autoverification is on, the editor checks that the tag names 
used in the derived tag file, actually exists in the CVD. 


Examples: DERIVED Command 
DERIVED dtg2 


Opens the Derived Tags Editor containing the file dtg2, and verifies that 
the tags mentioned in the file exist in the loaded database. 


DERIVED dtg3 /n 


Opens the Derived Tags Editor containing the file dtg3, without verifying 
that the tags mentioned in the file exist in the loaded database. 


DERIVED 


Starts up the Derived Tags Editor with the default file, DTAGS. 


DERIVEDOFF 


Stops the derived tag processor and unloads the derived tag file. 
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Derived Tags Commands 


DERIVEDON DERIVEDON [file] 


Loads a derived tag file and starts the derived tag processor. The parameter 
is: 


[file] Is the name of the derived tag file (without a file 
extension). If you omit [file], the default file, DTAGS, is 
loaded. 


Example: DERIVEDON Command 
DERIVEDON DTG2 


Loads the derived tag file DTG2, and begins processing that file. 


Important: A database must be loaded before the processor is started and 
only one derived tag file may be processed at one time. 


A 
Address type, 1-1 
Arithmetic operators 

+ sign, 2-2 

— sign, 2-2 

* sign, 2-2 

/ sign, 2-2 

exponent, ** sign, 2-2 

MOD, % sign, 2-2 
Autoverification, 1-2, 1-8 


B 

Bitwise operators 
AND, &, 2-5 
complement, ~, 2-5 
exclusive OR, “, 2-5 
inclusive OR, |, 2-5 
left shift, <, 2-5 
right shift, >>, 2-5 

Built-in functions, 2-7 


C 

Change drive, 1-9 

Commands, A-1 

Comments in expressions, 2-15 
Configure Derived Tags Path 
window, 1-9 

Constants in math expressions, 2-2 
Copying a derived tag, 1-6 
Create a derived tag, 1-4 
Create a local tag, 1-1 

Current Value Database, 1-1 


D 
Database editor, 1-1 
Defining tags, 1-1 
Delete Derived Tag window, 1-5 
Deleting a derived tag, 1-5 
DERIVED, A-1 
Derived tag 
copying, 1-6, 1-7 
creating, 1-4 
deleting, 1-5 


description, 1-5 

expression, 1-5 

inserting, 1-4 

moving, 1-5, 1-6 

name, 1-5 
Derived Tag Editor, 1-1, 1-3 
Derived Tag Editor window, 1-3 
Derived tag file, create, 1-2 
Derived Tag File Attributes 
window, 1-7 
DERIVEDOFF, A-1 
DERIVEDON, A-2 
Description of derived tag, 1-5 
Description of file, 1-8 
Drive, 1-9 


E 

Edit Derived Tags window, 1-3 
Editing the database, 1-1 
Erasing a derived tag, 1-5 
Evaluation order, 2-10 
Evaluation period, 1-8 
Expression, 1-5, 2-1 
Expression components, 2-1 


F 
File functions, 2-10 
Formatting expressions, 2-15 
Functions 
involving file operations, 2-7 
involving tags, 2-7 
involving time, 2-7 


| 

IF-THEN-ELSE, 2-12 

Initial value, 1-1 

Insert a derived tag, 1-4 

Insert Derived Tag window, 1-4 


L 

Local tags, 1-1 

Logical operators 
AND, 2-4 


I-1 


Mathematical constants, 2-2 
Maximum number of derived tags, 
1-8 

Menu, Setup, 1-3 

Modify Derived Tag window, 1-4 
Modifying a derived tag, 1-3, 1-4 
Moving derived tag's position, 
1-5, 1-6 


N 


Name of derived tag, 1-5 
Nested IF-THEN-ELSE, 2-13 


0 


Operator precedence, 2-10 
Order of operations, 2-10 


P 
Path, 1-9 


R 
Relational operators 
EQ,= sign, 2-3 
GE, >= sign, 2-3 
GT,> sign, 2-3 
LE,<= sign, 2-3 
LT.< sign, 2-3 
NE, sign, 2-3 
Removing a derived tag, 1-5 


S 


Scan classes, 1-8 

Setup menu, 1-3 

Starting the Derived Tag 
processor, 1-9 

Statement, 2-1 

Stopping the Derived Tag 
processor, 1-10 

String tags, 1-1 


T 
Tag functions, 2-7 
Tag values, 2-2 
Time functions, 2-8 


W 

Window 
Configure Derived Tags Path, 
1-9 
Delete Derived Tag, 1-5 
Derived Tag File Attributes, 1-7 
Derived Tag File Editor, 1-3 
Insert Derived Tag, 1-4 
Modify Derived Tag, 1-4 
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